Follow-up to #23 (tweakcn theme import). Closes the last three items on issue #21.

What ships

1. shellui theme init <url> — one-shot init + apply

Combined command for greenfield setup. Runs InitService.InitializeAsync (Tailwind CLI download, App.razor patch, input.css, shellui.json, MSBuild wiring) then chains into ApplyThemeAsync — so a fresh project goes from empty to fully themed in one command:

dotnet shellui theme init https://tweakcn.com/themes/<id> --yes

Accepts the same options as init: --force, --style, --tailwind, --yes. Console output is two labelled steps so users can see which phase they're in if something fails.

Fits alongside the existing theme apply (existing project) and theme update (refresh from lock) — the full CLI surface is now:

shellui theme init <url>                                # fresh project — init + apply
shellui theme apply <url>                               # existing project — write to input.css
shellui theme apply <url> --emit-override <path>        # Path A/D — standalone override CSS
shellui theme update                                    # re-fetch from shellui.theme.lock

2. README coverage across all install-path docs

Three READMEs now cover the tweakcn workflow with concrete commands per install path:

3. path-c-cli-tweakcn/ demo — verified locally, not committed

The shellui-installation-tests/ directory is gitignored (per its README). Rather than land a fifth test project there that won't merge, I verified the flow end-to-end in a scratchpad:

• dotnet new blazor -n TestApp
• shellui theme init https://tweakcn.com/themes/cmgy5f2vg000504l42pep9ob1 --yes
• Step 1/2 (init) — Tailwind CLI downloaded, App.razor patched, input.css + app.css + tailwind.config.js + shellui.json + Build/ShellUI.targets created
• Step 2/2 (apply) — theme fetched (53 light + 52 dark vars = 128 oklch values in output), sentinel-marked block written to input.css, shellui.theme.lock written with correct SHA-256
• dotnet build succeeds; Tailwind rebuilds; components render with the tweakcn theme

Issue #21 status

All checkboxes now green:

Files

Net: +143 −14 across 4 files. No behavior change to init, apply, or update; no new tests needed (composition of two already-tested functions, smoke-tested end-to-end).

Test plan

• dotnet test — 76/76 green (unchanged; no new test surface)
• dotnet shellui theme --help — lists init, apply, update
• dotnet shellui theme init --help — shows <url> arg + --force / --style / --tailwind / --yes options
• End-to-end in scratchpad dotnet new blazor project — both steps complete, input.css contains @import "tailwindcss" + BEGIN/END sentinel + 128 oklch vars, shellui.theme.lock written
• Re-run theme init twice — second run is idempotent within the sentinel region